Software Vault: The Diamond Collection/The Diamond Collection (Software Vault)(Digital Impact).ISO/cdr24/1sword20.zip/SWORD.DOC

Text File | 1995-03-14 | 23KB | 494 lines

                               SwordSearcher v2.0
                         Authorized King James Version
      "...the sword of the Spirit, which is the word of God..." -Eph 6:17

    The SwordSearcher software and documentation is copyrighted (c) 1995 by
                      Brandon Staggs, Imperative Software.

CONTENTS BY SECTION NUMBER:

   1 Introduction
   2 System Requirements
   3 Shareware Notice
   4 Legal Stuff
   5 Distribution
   6 Contacting the Author
   7 Obtaining Site Licenses for Churches and Other Organizations
   8 Use of Text Obtained from the use of SwordSearcher

   9 General Use Instructions
  10 Commands - Main Search Screen
  11 Commands - Read Mode
  12 Setting Search Keys
  13 Case Sensitivity for Searches
  14 Whole Words or Word-Within-Word Searches
  15 Boolean Logic for Searches (OR/AND/XOR)
  16 Using all the Options Together
  17 Selecting Which Books to Search

  18 Notes on Large Searches
  19 Running SwordSearcher Under Windows



SECTION 1: Introduction

  SwordSearcher  is  an  integrated  Bible  and Concordance for your computer.
  SwordSearcher is an easy-to-use, mouse driven, and intuitive Bible study and
  research aid that doesn't sacrifice power for  ease  of  use.  SwordSearcher
  allows  you  to search the Bible for any word, phrase, combinations of words
  and/or phrases that you want.  You have maximum  control  over  the  search.
  Searches use boolean logic, can be case sensitive or ignore case, search for
  substrings or find only whole words, it's all up to you.  You can search the
  Old  or  New  Testament,  the  entire Bible, or any combination of books you
  specify.

  And  it  doesn't  stop  at  the  search.   Your  results  are displayed in a
  scrolling window, entire verses and references. The  matching  word,  words,
  and/or phrases are highlighted.  This allows you to quickly scan for a verse
  you need.

  In  this  window,  you can tag verses to save to a file or print directly to
  your printer.  You can simply point to  a  verse  and  click  on  it  to  go
  directly  to the passage of the Bible it appears in, and read as far forward
  or backward you wish.

  You can also browse the Bible in SwordSearcher's read-mode. You can save  or
  print  any passages you want and set a bookmark, which remains there as long
  as SwordSearcher is on your hard drive, or until you move it.

  SwordSearcher allows your studies to become more productive.  Once  you  use
  SwordSearcher,  you'll  never  want  to  page  through a printed concordance
  again.


SECTION 2: System Requirements

  To run SwordSearcher, you  must  have:  a  386  or  better  processor,  520K
  conventional  memory, at least 1 megabyte of Extended Memory (XMS), at least
  2 megabytes of hard drive space, a Microsoft compatible  mouse,  and  a  VGA
  display.

  SwordSearcher  will  take advantage of systems with 5 megabytes of free XMS,
  which will improve performance.  For systems with less than 5  megabytes  of
  XMS,  a  disk  cache  is  recommended.   Some  searches  may require up to 5
  megabytes of hard drive space to complete.


SECTION 3: Shareware Notice

  SwordSearcher   is   distributed   as    shareware.     Shareware    is    a
  "try-before-you-buy"  method  of  selling  software.  You may use this trial
  version of SwordSearcher for up to one week to see if it meets  your  needs.
  If  you  decide to keep using SwordSearcher, you must register (pay for) it.
  If you choose not to pay for SwordSearcher, you must cease using it.

  Please note that  this  trial  version  of  SwordSearcher  is  identical  in
  function and operability to the registered (commercial) version.  The author
  believes  that  you  should  be able to use the product in its complete form
  before you actually buy it.  This system is based  on  your  honor.   Please
  abide  by  this  "license,"  in  order  to  encourage the author's continued
  support and development of this software.  A laborer is worthy of  his  hire
  (Luke 10:7).

  Please  read  the file ORDER.DOC for registration instructions.  If for some
  reason you can't read this file, you can read the registration  instructions
  by  viewing  the  help  screen  in SwordSearcher and selecting "Registration
  Information."

  SwordSearcher is only $29.50 + $3.50 s/h  ($6  foreign).  That's  about  the
  cost of a printed Strong's Concordance.  Upon registration, you will be sent
  the  latest  version  of SwordSearcher with the shareware notices removed on
  3.5 HD floppies, a printed manual and  quick-reference  card,  discounts  on
  upgrades and technical support information.


SECTION 4: Legal Stuff

  SwordSearcher  is  provided  AS IS, with no warranties expressed or implied.
  The user of this software agrees not to hold the author or any  distributors
  accountable  for any alleged damages of any kind caused by the use or misuse
  of this software or anything related to this software.  Use of this  product
  indicates agreement to these terms.


SECTION 5: Distribution

  You are authorized, and even encouraged, to distribute this trial version of
  the  software, provided no modifications are made whatsoever to the software
  or its accompanying documentation files, and provided that all of the  files
  listed   in   the   MANIFEST.DOC  file  are  included  unmodified  with  the
  distribution.

  The shareware concept thrives  on  user  distribution.   Please  share  this
  program  with your friends and upload it to your favorite BBSs.  You may not
  charge for anything but a small duplication fee.

  Shareware vendors have additional restrictions. Please  see  the  VENDOR.DOC
  file for more information.

  If your company is interested in retail sale of the registered version, or a
  future Windows or DOS commercial version, please contact me.


SECTION 6: Contacting the Author

  I  welcome  your  questions and comments.  There are two ways to contact me.
  The preferred way is  through  Internet  e-mail.   My  Internet  address  is
  <[e-mail]>  (without  the  brackets).  You can send me surface mail
  (postal service) at:

     Brandon Staggs
     Imperative Software
     Po Box 1019
     Hanalei, HI
     96714

SECTION 7: Obtaining Site Licenses for Churches and Other Organizations

  If you would like to obtain a license for a limited number  of  machines  at
  your  Church  or other organization, please contact me.  I do give discounts
  for these types of purchases.  Please do not  call  the  1-800  credit  card
  order  line with these enquiries. They can not, will not, and are completely
  unable to answer such questions.  You must contact me personally.


SECTION 8: Use of Text Obtained from the use of SwordSearcher

  While using SwordSearcher you can obtain passages from  the  Bible  in  text
  form.  The author claims no rights on these texts. You may freely distribute
  any  text  from  the Bible that you obtain through the use of SwordSearcher,
  trial or registered versions. In fact, you  are  encouraged  to.   The  King
  James Bible is not copyrighted.


SECTION 9: General Use Instructions

  The   following  is  an  example  of  how  to  use  SwordSearcher.  Detailed
  descriptions of commands and options are in following sections.

  To start, run SwordSearcher.

  Notice  that  if  you  have  enough  memory  available,  SwordSearcher  will
  decompress  the  Bible  into XMS.  This allows for much faster searches, and
  much smoother  book-to-book  switching  while  in  read-mode  and  examining
  context. However, sometimes you may not want to wait for this (this can take
  a  while on slower machines), so you can just press ESCape and SwordSearcher
  will skip the decompression.

  You should now be at the main  search  screen.   Here  you  will  see  three
  windows  and a "command strip." The upper-left window is where you configure
  the search parameters.  The upper-right window is  where  you  select  which
  books  you  want  SwordSearcher  to  search  for the "Specific Books Search"
  option.  The  bottom  window  is  where  all  of  the  matching  verses  are
  displayed.

  In  order to configure a search, you should first specify the "search keys."
  To do this, either click on "Search string" with the mouse, or press F1.

  For the purpose of this example,  we  will  only  specify  one  search  key.
  Enter  "cain"  as  the search string (without the quotes).  Use the mouse to
  select "Okay" or press ENTER when you're done.

  For this search, we want the search to be "substring inclusive." This  means
  we want SwordSearcher to count verses as matching when they contain the word
  "cain"  either  as  a whole word, or as part of a larger word.  To set this,
  use the mouse to click on the "[ ]" next to "Include  Word-Within-Word,"  or
  press F4 to toggle between Whole Word/Word-Within-Word.

  We can leave all the rest of the options as they are.

  To  begin  the  search,  either  use  the mouse to click on the "<B>" on the
  command strip, or press B.

  If  the  search  parameters  are  all  set,   the   search   should   begin.
  SwordSearcher  keeps  you updated on the status of the search.  It tells you
  what book it is currently searching, and how many verses  it  has  found  so
  far.    At  any  time  you  can  press  ESCape  to  abort  the  search,  and
  SwordSearcher will display  the  verses  (if  any)  it  has  already  found.
  Depending  on  the  speed of your computer and whether or not you have extra
  XMS, the search should be complete in just a  few  seconds  up  to  about  a
  minute.

  After the search is complete, you should see the verses in the New Testament
  that  contain  the  string  "cain"  in them.  Notice that the word "cain" is
  highlighted in each verse.  The reference to each verse is on the left in  a
  different color.

  In  this search, the word "cain" is highlighted regardless of case (that is,
  it doesn't matter if any letters are upper or lower case),  and  whether  or
  not  it  is  a  whole word, or just part of a larger word.  You have control
  over all of these options.

  There is a "verse pointer" on the left of the lower window. This is  just  a
  filled  in arrow pointing right.  If you only want to use the mouse, you can
  ignore this arrow.  However, if you use the  keyboard's  cursor  positioning
  keys (the arrow keys and the Page keys), this arrow is important.

  To move this verse pointer, use the up and down arrow keys. You can also use
  the  page  and  home/end keys.  See Section 10 for a detailed explanation of
  each key.  If there are more verses than fit in the window,  the  text  will
  scroll  when the pointer is at the top or bottom and you press a key to move
  it further.

  Now, lets examine the context of one of the verses.  There are several  ways
  to  do  this.   You can use the mouse by pointing to the verse you want, and
  clicking the LEFT mouse button.  Or, you can move the verse pointer  to  the
  verse  you  want and press one of several keys.  For this example, press the
  RIGHT ARROW key.  Please note that if you point at  a  blank  space  (either
  with  the  mouse  or the verse pointer), nothing will happen when you try to
  examine the context.  You must be pointing at actual text.

  You should now be in  "read-mode."  The  reference  to  the  verse  you  are
  examining should be flashing.  In this mode, you can scroll the text forward
  or  backward to read as much of the passage as you like.  There are commands
  for switching to other books too, explained in Section 11.

  After you read what you need to, you can go back to the main  search  screen
  either  by  pressing Q or the LEFT ARROW, or by using the mouse and clicking
  on the "<Q>" in the command strip.  There are  other  commands  for  exiting
  read-mode, explained in Section 11.

  You should be back on the main screen right where you left off.

  Now  let's  tag  a  verse  to  print it (this, of course, assumes you have a
  printer attached to your computer).  To tag a verse, you can use  the  mouse
  to  point  at  the verse (the same way you do for examining the context of a
  verse) and clicking the RIGHT mouse button.  You can  also  move  the  verse
  pointer to the verse you want to tag and use the mouse to click on the "<T>"
  in the command strip, or press T, or press SPACE.

  When you tag a verse, the reference will change color so you can easily tell
  which verses are tagged.

  Now,  lets  print this verse.  Either use the mouse to click on the "<P>" in
  the command strip, or press P. If you don't have a printer, or your  printer
  is off-line or out of paper, the message "Printer Unavailable" will appear.

  If  you  have a printer, you will be presented with a choice. You can either
  print the tagged verses, the untagged verses, or all of  the  verses.   Make
  your  choice  with  either  the  mouse or the keyboard (you should be fairly
  comfortable with the controls by now).

  If you have a dot-matrix  printer,  you  should  have  heard  that  annoying
  screech  and see the verse or verses on the paper.  If you have a bubble-jet
  or laser printer, chances are nothing happened.   The  reason  for  this  is
  that  in  order  for  a laser printer to spit out the page, it either has to
  have a full page of information to print, or a form-feed command.   Look  in
  your  printer  manual  if you don't know how to issue a form-feed command on
  your printer's control console.

  The  reason  SwordSearcher does not automatically issue form-feeds is so you
  can do multiple searches and prints without wasting tons of blank  space  on
  paper.  This  way,  all  the  verses  are  printed one after another without
  wasting paper.  So, you should always check to make sure  your  printer  has
  spit  out  all  the  verses  you wanted before you turn it off.  (Most laser
  printers have a flashing FF light to warn you.)

  Now  you  have  sampled just a small portion of SwordSearcher's commands and
  abilities.  The best way to learn the rest of SwordSearcher's  commands  are
  through experimentation and reading the rest of this manual.


SECTION 10: Commands - Main Search Screen

  Mouse:

  Click on any "[ ]" to toggle option.
  Click on any "< >" to activate command.
  LEFT click on a verse to examine its context.
  RIGHT click on a verse to toggle tag on/off.

  Keyboard:

  [F1] Change search string
  [F2] Toggle case sensitive
  [F3] Toggle OR/AND/XOR search
  [F4] Toggle word-within-word
  [F5] Toggle Entire/New/Old/Specific book search

  [F9] Toggle all books in upper-right window ON for specific book search
  [F10] Toggle all Old Testament books in upper-right window ON for specific
        book search
  [F11] Toggle all New Testament books in upper-right window ON for specific
        book search
  [F12] Toggle all books in upper-right window OFF for specific book search

  [Q] Quit SwordSearcher
  [R] Go into read-mode for Bible browsing
  [B] Begin Search
  [S] Save results to a file
  [P] Print results
  [H] Help screen
  [C] [ENTER] Examine the context of the verse pointed to by the verse pointer
  [T] [SPACE] Toggle tag on/off of the verse pointed to by the verse pointer

  [CTRL-T] Toggle all verse tags on/off
  [CTRL-U] Untag all verses
  [ALT-X] Quick quit

  [UP ARROW] Move verse pointer up one line
  [DOWN ARROW] Move verse pointer down one line
  [PAGE UP] Move verse pointer up one page
  [PAGE DOWN] Move verse pointer down one page
  [HOME] [CTRL-PAGE UP] Move verse pointer to the first verse in the list
  [END] [CTRL-PAGE DOWN] Move verse pointer to the last verse in the list
  [CTRL-UP ARROW] Move the verse pointer to the first line on the current page
  [CTRL-DOWN ARROW] Move the verse pointer to the last line on the current
                    page
  [RIGHT ARROW] Examine the context of the verse pointed to by the verse
                pointer


SECTION 11: Commands - Read Mode

  Mouse:

  Click on any "< >" to activate command.

  Keyboard:

  [Q] [ESC] Quit reader
  [M] Set bookmark on current page
  [B] Go to bookmark
  [G] Go to a passage
  [S] Save a passage to a file
  [P] Print a passage
  [H] Help screen

  [DOWN ARROW] Scroll Scripture forward
  [UP ARROW] Scroll Scripture backward
  [PAGE DOWN] Page Scripture forward
  [PAGE UP] Page Scripture backward
  [HOME] [CTRL-PAGE UP] Go to the beginning of the current book
  [END] [CTRL-PAGE DOWN] Go to the ending of the current book
  [CTRL-UP ARROW] [CTRL-LEFT ARROW] Go to the preceding book
  [CTRL-DOWN ARROW] [CTRL-RIGHT ARROW] Go to the next book
  [LEFT ARROW] Quit reader


SECTION 12: Setting Search Keys

  SwordSearcher allows you to specify up to ten words and/or phrases to search
  for.   Each  word  or  phrase  is  considered a search "key." If you want to
  search for more than one word or phrase, you must separate them with a slash
  ("/").

  For example, if your want to search for "Abel," "Cain," "Adam,"  and  "Eve,"
  your  search string would be "Abel/Cain/Adam/Eve" (without the quotes).  You
  can also do phrases.  For  example,  "Lord  of  Lords".   You  can  also  do
  multiple  phrases,  like  "Lord  of  Lords/King  of Kings".  You can combine
  phrase and word searches, like "Lord of Lords/Christ".  You can have  up  to
  ten keys altogether.

SECTION 13: Case Sensitivity for Searches

  SwordSearcher allows you to configure your searches to be case sensitive, or
  non-case sensitive.  A case sensitive search means that the search keys have
  to  match  the  case (upper/lower case letters) of the word(s) in the verse.
  For example, a case sensitive search for "God" would return only verses with
  upper-case "God." A non-case sensitive search for "God" would  return  words
  like  "God"  and  "god." Note that case sensitivity is not restricted to the
  first letter.  A case sensitive search for "GoD" is not likely  to  turn  up
  anything.


SECTION 14: Whole Words or Word-Within-Word Searches

  SwordSearcher  allows  you  to  configure  your  searches  to  be "substring
  inclusive." This means that you can configure your search to include matches
  where the key is a part of a larger word in the verse.   Or,  you  can  have
  your search be "whole words only."

  For  example,  if  you did a "whole words only" search for "god," the search
  would only count verses as matching when "god" is a whole word in the verse.
  If you did a "word-within-word" search for "god," your results would include
  words like "god," "ungodly" and "godly."

  Word-within-word searches for phrases work too.  For example, if you  did  a
  word-within-word  search  for "lord of lord", the search would find "lord of
  lords." However, it would NOT find a phrase like "lords of  lord,"  even  if
  there were such a phrase in the Bible.


SECTION 15: Boolean Logic for Searches (OR/AND/XOR)

  SwordSearcher  uses  "boolean  logic"  in  its  searching.   You  have three
  "operators" you can choose from in configuring your search: OR, AND, and XOR
  (exclusive or).  For example,  take  the  search  string  "Abel/Cain".   The
  search keys in this string are "Cain" and "Abel".

  OR  search: An OR search would find verses which have either "Cain", "Abel",
  or both "Cain" and "Abel" in them.  In other words,  an  OR  search  returns
  verses that have at least one of the search keys in them.

  AND  search:  An  AND  search  would  find verses which have both "Cain" and
  "Abel" in them.  In other words, an AND search returns verses  that  contain
  ALL of the search keys in them.

  XOR  search:  An  XOR  search  would find verses which have either "Cain" or
  "Abel" in them, but NOT with BOTH "Cain"  and  "Abel"  in  them.   In  other
  words,  an  XOR search returns verses which have ONLY ONE of the search keys
  in them.  If a verse has more than one of the search keys in them, the verse
  is NOT a match.


SECTION 16: Using all the Options Together

  SwordSearcher gives you maximum control over your searches. All of the above
  options  always  work  in conjunction which each other.  The best way to get
  the hang of this is through experimentation.


SECTION 17: Selecting Which Books to Search

  SwordSearcher allows you to search the books of the Bible however  you  wish
  in any combination.

  Select  "Search  Entire  Bible"  to  search every book of the Bible.  Select
  "Search Old Testament" to search only the books of the Old Testament. Select
  "Search New Testament" to search only the books of the New Testament.

  Select "Search Specific Book(s)" to search only the books you specify in the
  upper-right window.  Select which books you want searched in a specific book
  search by clicking on the "[ ]" next to the book you want  searched  in  the
  upper-right  window.  Click  on  it again to deselect it.  You can select as
  many or as few books as you want.  You can also use the  keys  explained  in
  Section 10 to select specific books.


SECTION 18: Notes on Large Searches

  SwordSearcher  uses  your  hard  disk  as  a temporary storage space for the
  results of the search.  You should keep this in mind when (and  if)  you  do
  unusually long searches like the word "the." These types of searches require
  considerable amounts of hard drive space (and time) to complete.

  To  give  you  an  idea,  if you did a word-within-word, non-case sensitive,
  entire Bible search for the letter "e," the search would require  about  5.5
  megabytes  of hard drive space to complete.  The more results there are, the
  larger the space required.


SECTION 19: Running SwordSearcher under Windows

  SwordSearcher, if installed properly, will run just fine (if a  bit  slower)
  under Microsoft Windows.  SwordSearcher includes a .PIF (program information
  file)  and  a  .ICO  (icon)  file  for  Windows.   Please  see  your Windows
  documentation for instructions on installing a DOS program into Windows.

  DO NOT run more than one copy of SwordSearcher  at  a  time  under  Windows,
  unless you have them in separate directories. SwordSearcher does not "share"
  its data files with multiple instances of itself, and will not run.

  You  should not allocate more than 1 megabyte of XMS for SwordSearcher under
  Windows unless you  have  an  enormous  amount  of  memory  and  you  "lock"
  SwordSearcher's  XMS memory in the PIF. SwordSearcher will usually just slow
  down if you do.  For details on all of this, see your Windows documentation.

  SwordSearcher has been designed to run in DOS.  It runs satisfactorily under
  Windows, but not as fast and not as well. There will most likely be a future
  Win95 version of SwordSearcher.  Feel free  to  send  your  suggestions  for
  future versions to the author.